home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 40 / q40.d81 / t.trek searcher < prev    next >
Text File  |  2022-08-28  |  10KB  |  230 lines
  1.  
  2.  
  3.                          T R E K   S E A R C H E R
  4.  
  5.                      Program and Text by Knees Calhoon
  6.  
  7.                       Additional Data by David Elliott
  8.  
  9.  
  10.     This program began as a series of geoWrite documents by Dave Elliott of
  11. Cippenham England. Each contained lots of information about the episodes of
  12. Star Trek, ST:The Next Generation and Deep Space Nine. I planned on
  13. publishing them as Geosware but never could find the space on LOADSTAR 64.
  14. Part of the problem was that I am not a big Geos user and I felt that the
  15. graphic quality of geoWrite was overkill for what is essentially pure
  16. text.
  17.  
  18.     But then I remembered a program that I had done for LOADSTAR 128 a long
  19. time ago about astronomy. It was a database of Messier objects and its data
  20. was very similar to what Dave had in his geoWrite files. Maybe I could
  21. revamp THE ASTRONOMER to fit the data. It was a crazy idea but it just
  22. might be crazy enough to work!
  23.  
  24.  
  25.  THE TREK SEARCHER PROGRAM
  26.  -------------------------
  27.  
  28.     Dave also sent me information about Voyager but since that series is
  29. still being made, I decided to limit this program to the classic, original
  30. Star Trek, ST:The Next Generation and Deep Space Nine. When run, the
  31. program gives you a CRSR UP/DOWN and RETURN menu of your options:
  32.  
  33.  Classic Star Trek (database)
  34.  Classic Timeline
  35.  ST: The Next Generation (database)
  36.  ST:TNG Timeline
  37.  Deep Space Nine (database)
  38.  DS9 Timeline
  39.  Help Screen
  40.  Quit to LS 128
  41.  
  42.     The three database options take you to a screen where information about
  43. each episode is displayed. The timelines take you to a scrolling screen
  44. with information about the future, as chronicled by the series. The HELP
  45. screen describes the workings of the menus and QUIT returns you to LOADSTAR
  46. 128 if there is a LS 128 disk in the current drive.
  47.  
  48.  
  49.  THE DATABASES
  50.  -------------
  51.  
  52.     When you select one of these, you see a screen with seven "fields"
  53. showing data about Episode 1. The NUMBER field is just for a numerical
  54. reference -- it does not necessarily mean that the episode shown was the
  55. "first episode" shown on TV. The episodes ARE displayed in the order they
  56. were aired on U.S. TV but they may not be numbered as Star Trek officially
  57. numbers them.
  58.  
  59.     The other fields are:
  60.  
  61.  EPISODE TITLE - The name as it appeared on the credits.
  62.  
  63.  WRITER(S) - If two people collaborated on a script, they are listed as
  64. Author One AND Author Two. If the script was written by Author One from a
  65. story or book by Author Two, then they are listed as Author One/Author
  66. Two.
  67.  
  68.  LOCATION - This is the name of the planet or system where most of the
  69. action takes place. If it is an unknown or uncharted planet, then I may
  70. have called it by the name of the person or creature that lives there.
  71.  
  72.  NOTE: I had trouble coming up with details about the last season of Deep
  73. Space Nine so LOCATION for the episodes is simply "DS9". Feel free to edit
  74. the data files (see below) with better information.
  75.  
  76.  AIRDATE - The is the date that the episode was first aired on U. S.
  77. television in MO-DA-YR format. Yes, I have introduced the Y2K bug in this
  78. program. In the year 2066, users of Commodore 8-bit software may curse me
  79. for confusing them, especially if Star Trek spinoffs are still being made.
  80.  
  81.  STARDATE - The dates of the episodes as given by Kirk, Picard and Sisko's
  82. logs. In the world of Star Trek the first digit stands for the century; the
  83. second for the season number; the third, fourth and fifth digits point to
  84. the part of the season; and the decimal divides the day into ten periods.
  85. Keep in mind that in the earlier episodes this system was not strictly
  86. adhered to.
  87.  
  88.  NOTES - This is a field that the user can use to keep up to 32 characters
  89. of notes about the episode.
  90.  
  91.     You can navigate through the episodes by pressing CRSR UP/DOWN or F1
  92. and F2 to move one episode forward or backward. There are 80 Classic, 177
  93. TNG, and 162 Deep Space Nine episodes. Use F3 and F4 to move ten episodes
  94. at a time. You can go directly to a particular episode by simply typing the
  95. number of the episode. You must enter three digits, using two leading
  96. zeroes for episodes 1 through 9 and one zero for episodes 10 through 99.
  97.  
  98.     Press H for the Help screen and M to return to the first menu.
  99.  
  100.  
  101.  SEARCHIN' THE DATABASES
  102.  -----------------------
  103.  
  104.     Press S and you'll be prompted to select a field to search. Press the
  105. SPACE BAR or CRSR DOWN to move the "highlight" to the field you want. Note
  106. that the highlight is a simulation of the button being pressed IN. Press
  107. RETURN when the desired field is highlighted and you're prompted to enter
  108. an EXACT word or phrase to search for.
  109.  
  110.     The Search routine uses BASIC 7.0's INSTR$ command so you can search
  111. for anything in the field, as long as it's an exact match. For instance,
  112. searching for "the" will find "By Any Other Name" as well as "Dagger of the
  113. Mind" and others. If the string is anywhere in the field, it will be found.
  114. The search is case-sensitive so searching for "The" will not find episodes
  115. with "the" in the title.
  116.  
  117.     When you search the STARDATE field, you can enter a range of numbers to
  118. search for, separated by a dash (-). Enter 3405.5-3800.3 and all episodes
  119. that take place between those two stardates will be found. To search for
  120. any episode after stardate 4300, enter 4300-9999; to find episodes prior to
  121. stardate 3000, enter 0-3000. Unknown stardates will show up in this range.
  122.  
  123.     The AIRDATE is also a numerical field but since the dates are not
  124. numbered in a logical, numeric sequence, I felt that the INSTR$ search was
  125. better suited. To find all episodes shown in 1967, search for -67.
  126.  
  127.     Before each search you are asked if you want the report sent to the
  128. printer at the same time it's sent to the screen. If you answer Yes then
  129. each match will be printed and the search will automatically continue until
  130. the file is exhausted. If you answer No then you'll have to press a key
  131. after each match is displayed to go to the next match.
  132.  
  133.     The print format is one that I felt was appropriate. It prints all the
  134. fields for an episode on four lines of paper then skips a line before
  135. printing the next match. If you want to change the format of the printout,
  136. feel free. The print routine is at lines 500 to 580.
  137.  
  138.  
  139.  EDITING FIELDS
  140.  --------------
  141.  
  142.     The first version of this program only allowed editing the NOTES field,
  143. but then I figured that it would be easy enough to allow all of the fields
  144. to be edited. Of course, one way to edit would be to edit the data files
  145. directly with TWS or any word processor that supports PETASCII PRG files.
  146.  
  147.     To edit a field, press E and then choose the field as you did with
  148. Search. An input box just the size of the field opens up at the bottom of
  149. the screen. Enter the new data and press RETURN.
  150.  
  151.  IMPORTANT: When you edit a field, it's registered only in memory, not on
  152. disk. After each editing job you are asked if you want to save the data
  153. file. You don't have to save every time, but be sure to save the file
  154. before quitting the program or loading another data file. The edited data
  155. is not sent to disk until you SAVE it.
  156.  
  157.  
  158.  THE TIMELINES
  159.  -------------
  160.  
  161.     When you select a timeline you get a scrolling window with information
  162. compiled by Dave Elliott in it. Use the CRSR UP and DOWN keys to scroll the
  163. info.
  164.  
  165.     You can search the timeline for any word or string by pressing S. Enter
  166. the EXACT word or phrase and when a match is found, the line it's in will
  167. appear at the top of the window. Press any key to go to the next match.
  168.  
  169.  
  170.  THE DATA FILES
  171.  --------------
  172.  
  173.     I created the data files from those given me by Dave Elliott by using
  174. THE WRITE STUFF 128. For each episode the following format is used:
  175.  
  176.  episode name - (58 characters maximum)
  177.  writer(s) - (41 maximum)
  178.  location - (28 maximum)
  179.  airdate - MO-DA-YR format (for best results always use the same date
  180.            format for all data)
  181.  stardate - xxxx.x-yyyy.y or xxxx.x
  182.  notes - (32 maximum) most are left empty, for users to use as they wish
  183.  
  184.     Each episode uses six lines and each episode's data immediately follows
  185. the last. The file was printed to disk as a PETASCII PRG file. Programmers
  186. who want to use this data can easily parse it for their own use.